home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / bbs / bkey210.zip / ADVANCED.DOC next >
Text File  |  1997-04-28  |  9KB  |  207 lines
  1. BlueKey's Advanced Document                                             Page 1
  2. ──────────────────────────────────────────────────────────────────────────────                   
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                    ┌──────────────────────────────────────┐
  14.                    │ ▄▄▄▄ ▄▄   ▄▄ ▄ ▄▄▄▄   ▄▄ ▄ ▄▄▄▄ ▄▄ ▄ │
  15.                    │ ██▄█ ██   ██ █ ██▄    ██▄▀ ██▄  ██▄█ │
  16.                    │ ██▄█ ██▄█ ██▄█ ██▄▄   ██ █ ██▄▄ ▄▄▄█ │
  17.                    ├──────────────────────────────────────┤
  18.                    │          PGP shell for OLRs          │
  19.                    └──────────────────────────────────────┘
  20.                                  Version 2.10
  21.                        by Yariv Habot of MasTic Products
  22.  
  23. ┌──────────────┐
  24. │   Contents   │
  25. └──────────────┘
  26.  
  27.         Topic:                                                    Page:
  28.         
  29.         Additional Files ............................................ 2
  30.         "MyName" .................................................... 2
  31.         Encryption .................................................. 2
  32.         MultiEncryption ............................................. 2
  33.         Decryption .................................................. 3
  34.         Signatures .................................................. 3
  35.         Import/Export of Keys ....................................... 3
  36.         Backup ...................................................... 4
  37.         Editors' Choice ............................................. 4
  38.  
  39.  
  40.  This document is meant for those who wish to configure BlueKey to fit all
  41.  their needs, and for those who need to know more about BlueKey. If you
  42.  haven't installed BlueKey yet, do so now and then read this file. 
  43.  
  44. BlueKey's Advanced Document                                             Page 2
  45. ──────────────────────────────────────────────────────────────────────────────                   
  46.  
  47. ┌──────────────────┐
  48. │ Additional Files │
  49. └──────────────────┘
  50.  While running, BlueKey works with several files it writes to your disk,
  51.  which were not included in the original archived file:
  52.  
  53.  BLUEKEY.CFG - The main configuration file BlueKey works with. This file
  54.                is written when you exit BKSETUP and is being updated by 
  55.                BlueKey.
  56.  
  57.  HISTORY.DAT - This file keeps the list of the userids you chose to encrypt
  58.                to in this menu before.
  59.  
  60.  GROUPS.DAT  - Keeps the groups definitions.
  61.  
  62.  BLUEKEY.TM* - These are files BlueKey opens, closes and deletes during any
  63.                run. In case you find such files on your disk, it means some
  64.                error probably left those files there. Remove them, there's
  65.                no need for these files.
  66.  
  67. ┌──────────────┐
  68. │   "MyName"   │
  69. └──────────────┘
  70.  PGP's MyName keyword is used by BlueKey when self-encrypting messages. Users
  71.  can choose between two userids either by the "Change userid" option on
  72.  BlueKey's menu or by including the switch /u1 or /u2 on BlueKey's command
  73.  line.
  74.  
  75. ┌──────────────┐
  76. │  Encryption  │
  77. └──────────────┘
  78.  When you choose to encrypt a message, these are the procedures BlueKey runs:
  79.  
  80.  First, the message will be stripped of tearlines, taglines and the origin 
  81.  line. These lines will be added back once the message itself was encrypted.
  82.  BlueKey will also try to identify and remove your signature if you specified
  83.  the name of your signature file in setup. If you have your signature in
  84.  a template, consider copying it to an external file as well.
  85.  
  86.  The recipients should be on BlueKey's command line. It is also possible to
  87.  pick recipients by using BlueKey's MultiEncryption menu.
  88.  Then BlueKey calls PGP for encryption. Output file is kept in an ASCII
  89.  format.
  90.  
  91. ┌─────────────────┐
  92. │ MultiEncryption │
  93. └─────────────────┘
  94.  BlueKey's MultiEncryption menu allows the user to tag userids from three
  95.  sources: The history list, the keyring and the groups definitions. Simply
  96.  copy the userids from the lists (by using the Right Arrow key, or by tagging
  97.  and clicking on the arrow) to the "EncryptTo" window and that's it.
  98.  This menu is also meant to configure the groups definitions. You can copy
  99.  any userid to an existing group, or add new groups and userids in the
  100.  Groups screen.
  101.  
  102.  
  103. BlueKey's Advanced Document                                             Page 3
  104. ──────────────────────────────────────────────────────────────────────────────                   
  105.  
  106. ┌──────────────┐
  107. │  Decryption  │
  108. └──────────────┘
  109.  As you probably know by now, BlueKey can be used on reply messages. It is
  110.  the only way to run it in Blue Wave, and it is optional when installed in
  111.  Termail.
  112.  If BlueKey decryption command is run on a reply message, BlueKey will run
  113.  a viewer after decrypting the message, in order to allow you to read the
  114.  decrypted message. You can then choose to reply or exit. When you choose
  115.  to reply, BlueKey will reformat the text, and produce a regular reply
  116.  message, with all the quote signs and lines in place.
  117.  
  118.  If the original message contains other text than the pgp encrypted lines,
  119.  BlueKey will put it in place. 
  120.  
  121.  If the message is not a reply message, the user will not enter the viewer.
  122.  Instead, your editor will present you with the message, ready for editing.
  123.  
  124.  BlueKey's decryption command can also be used for checking signatures on
  125.  PGP signed messages. This feature is for use in Termail and GoldED alone.
  126.  In order to check signatures in Blue Wave, you should use SignChk, another
  127.  MasTic product, which replaces your Blue Wave external viewer. Check out
  128.  "Distribution" in BLUEKEY.DOC to see where you can obtain the newest
  129.  version of SignChk (sigchk*.*).
  130.  
  131. ┌──────────────┐
  132. │  Signatures  │
  133. └──────────────┘
  134.  BlueKey can either clearsign ("/s" on the command line or choosing "S" on  
  135.  the menu) or sign ("/i" on the command line or choosing "I" on the menu).
  136.  Clearsign means signing your message in a way that keeps the message readable
  137.  without running PGP. Signing your message means you should run PGP to
  138.  check the signatures.
  139.  
  140.  Output file is kept in an ASCII format.
  141.  
  142.  To learn how to check signatures in BlueKey, read the last paragraph of
  143.  "Decryption" in this document.
  144.  
  145.  BlueKey also offers an option to sign and encrypt a message ("/b" on the
  146.  command line, or "B" on the menu). This is the same as encrypting a message,
  147.  but PGP will sign the message before encrypting it. Refer to "Encryption"
  148.  in this document to learn more about encrypting using BlueKey.
  149.  
  150. ┌───────────────────────┐
  151. │ Import/Export of Keys │
  152. └───────────────────────┘
  153.  Export key from message
  154.   
  155.   This option ("/1" on the command line or "1" on the menu) will add a key 
  156.   (which is given in ASCII format in a message) to your keyring. This option 
  157.   is used only for this specific purpose. Refer to PGP documentation to learn 
  158.   more about this option.
  159.  
  160. BlueKey's Advanced Document                                             Page 4
  161. ──────────────────────────────────────────────────────────────────────────────                   
  162.  
  163.  Import key to message
  164.    Use this option to ("/2" on the command line or "2" on the menu) import a 
  165.    key from your keyring in ASCII format. This will prompt you for an userid
  166.    and will then append the key to the end of your message. This option does 
  167.    NOT sign your message. Refer to PGP documentation to learn more about this 
  168.    option.
  169.  
  170. ┌──────────────┐
  171. │    Backup    │
  172. └──────────────┘
  173.  BlueKey backs up your files before running any PGP command. The backup file 
  174.  is named "msgtemp.bak". In BlueKey's menu, you can choose to keep the backup 
  175.  files when exiting BlueKey. This will cause security problems, and you should 
  176.  be aware of the risk of leaving text files, possibly decrypted, on your disk.
  177.  
  178. ┌──────────────────┐
  179. │ Editors' Choice  │
  180. └──────────────────┘
  181.  
  182.  (No, BlueKey has not yet been announced as an Editors Choice product. This
  183.  chapter discusses the preparation of a multi-editors choosing batch file.)
  184.  
  185.  
  186.  If you'd like to have a set of editors to choose from when writing a message,
  187.  then one easy way would be to create a batch file to achieve this purpose.
  188.  Edit a file with the extension BAT, for instance EDITOR.BAT and enter the
  189.  following commands:
  190.  
  191.  [batch file]
  192.  @echo off
  193.  choice /c:123 "(1 - BLUEKEY, 2 - Q, 3 - EDIT.COM) "
  194.  if errorlevel 3 c:\dos\edit %1
  195.  if errorlevel 2 c:\qedit\q %1
  196.  if errorlevel 1 bluekey.exe %1
  197.  
  198.  Change the names of the editors to fit your needs. Then change the editor
  199.  command of BlueWave/Termail to the batch filename, i.e. EDITOR.BAT. Then,
  200.  when running the editor command, your reader will present you with the
  201.  line in quotes. Press the number of the editor you'd like to work with,
  202.  and that's it.
  203.  
  204.  
  205. -=[End of Document]=-
  206.  
  207.